Node / ReticulumProjects / Sideband.git / files / README.md

Displaying Rendered • View raw • Download

Sideband <img align="right" src="https://img.shields.io/badge/License-CC%20BY--NC--SA%204.0-lightgrey.svg"/>

Sideband is an extensible LXMF messaging client, situational awareness tracker and remote control and monitoring system for Android, Linux, macOS and Windows. It allows you to communicate with other people or LXMF-compatible systems over Reticulum networks using LoRa, Packet Radio, WiFi, I2P, Encrypted QR Paper Messages, or anything else Reticulum supports.

!Screenshot

Sideband is completely free, end-to-end encrypted, permission-less, anonymous and infrastructure-less. Sideband uses the peer-to-peer and distributed messaging system LXMF. There is no sign-up, no service providers, no "end-user license agreements", no data theft and no surveillance. You own the system.

This also means that Sideband operates differently than what you might be used to. It does not need a connection to a server on the Internet to function, and you do not have an account anywhere. Please read the Guide section included in the program, to get an understanding of how Sideband differs from other messaging systems.

Sideband provides many useful and interesting functions, such as:

• Secure and self-sovereign messaging using the LXMF protocol over Reticulum.

• Image and file transfers over all supported mediums.

• Audio messages that work even over LoRa and radio links, thanks to Codec2 and Opus encoding.

• Secure and direct P2P telemetry and location sharing. No third parties or servers ever have your data.

• Situation display on both online and locally stored offline maps.

• Geospatial awareness calculations.

• Exchanging messages through encrypted QR-codes on paper, or through messages embedded directly in lxm:// links.

• Using Android devices as impromptu Reticulum routers (Transport Instances), for setting up or extending networks easily.

• Remote command execution and response engine, with built-in commands, such as T383838ping, T383838signal reports and T383838echo, and full plug-ing expandability.

• Remote telemetry querying, with strong, secure and cryptographically robust authentication and control.

• Plugin system that allows you to easily create your own commands, services and telemetry sources.

Sideband is fully compatible with other LXMF clients, such as MeshChat, and Nomad Network. The Nomad Network client also allows you to easily host Propagation Nodes for your LXMF network, and more.

Sideband can run on most computing devices, but installation methods vary by device type and operating system. For installation instructions, please find the relevant section below.

• Android

• Linux

• Raspberry Pi

• MacOS

• Windows

For your Android devices, you can install Sideband through F-Droid, by adding the Between the Borders Repo, or you can download an APK on the latest release page. Both sources are signed with the same release keys, and can be used interchangably.

After the application is installed on your Android device, it is also possible to pull updates directly through the Repository section of the application.

On all Linux-based operating systems, Sideband is available as a T383838pipx/T383838pip package. This installation method includes desktop integration, so that Sideband will show up in your applications menu and launchers.

You will first need to install a few dependencies for audio messaging and Codec2 support to work:

T282828

sudo apt install pipx python3-pyaudio python3-dev build-essential libopusfile0 portaudio19-dev codec2 xclip xsel

T8b949e# For Manjaro and derivatives

pamac install python-pipx python-pyaudio base-devel codec2 xclip xsel

T8b949e# For Arch and derivatives

sudo pacman -Sy python-pipx python-pyaudio base-devel codec2 xclip xsel

Once those are installed, install the Sideband application itself:

T282828

pipx install sbapp

After installation, you can now run Sideband in a number of different ways:

T282828

T8b949e# you may need to use the following command, to make your

T8b949e# installed applications available. You'll probably need

T8b949e# to close and reopen your terminal after this.

pipx ensurepath

T8b949e# The first time you run Sideband, you will need to do it

T8b949e# from the terminal:

sideband

T8b949e# At the first launch, it will add an application icon

T8b949e# to your launcher or apps menu. You may need to log out

T8b949e# of your session, and back in for the application to

T8b949e# show up in your launcher, depending on your distro.

T8b949e# You can also run Sideband in headless daemon

T8b949e# mode, for example as a telemetry collector:

sideband --daemon

T8b949e# You can also run Sideband with more verbose

T8b949e# log output enabled:

sideband -v

You can also install Sideband in various alternative ways:

T282828

pip install sbapp

T8b949e# Or, if pip is externally managed:

pip install sbapp --break-system-packages

T8b949e# Or, if you intend to run Sideband in headless

T8b949e# daemon mode, you can also install it without

T8b949e# any of the normal UI dependencies:

pip install sbapp --no-dependencies

T8b949e# In the above case, you will still need to

T8b949e# manually install the RNS and LXMF dependencies:

pip install rns lxmf

You can install Sideband on all Raspberry Pi models that support 64-bit operating systems, and can run at least Python version 3.11. Since some of Sideband's dependencies don't have pre-built packages ready for 64-bit ARM processors yet, you'll need to install a few extra packages, that will allow building these while installing.

Aditionally, the T383838pycodec2 package needs to be installed manually. I have provided a pre-built version, that you can download and install with a single command, or if you don't want to trust my pre-built version, you can build and install it from source yourself.

The install instructions below assume that you are installing Sideband on 64-bit Raspberry Pi OS (based on Debian Bookworm). If you're running something else on your Pi, you might need to modify some commands slightly. To install Sideband on Raspberry Pi, follow these steps:

T282828

sudo apt install python3-pip python3-pyaudio python3-dev python3-cryptography build-essential libopusfile0 libsdl2-dev libavcodec-dev libavdevice-dev libavfilter-dev portaudio19-dev codec2 libcodec2-1.0 xclip xsel

T8b949e# If you don't want to compile pycodec2 yourself,

T8b949e# download the pre-compiled package provided here

wget https://raw.githubusercontent.com/markqvist/Sideband/main/docs/utilities/pycodec2-3.0.1-cp311-cp311-linux_aarch64.whl

T8b949e# Install it:

pip install ./pycodec2-3.0.1-cp311-cp311-linux_aarch64.whl --break-system-packages

T8b949e# You can now install Sideband

pip install sbapp --break-system-packages

T8b949e# Restart your Raspberry Pi

sudo reboot

T8b949e# Everything is ready! You can now run Sideband

T8b949e# from the terminal, or from the application menu

sideband

A DMG file containing a macOS app bundle is available on the latest release page.

Please note that audio messaging functionality isn't supported on macOS yet. Please support the development if you'd like to see this feature added faster.

Alternatively, you can install Sideband with BT383838pip3on macOS:

T282828

pip3 install sbapp

T8b949e# Run it:

python3 -m sbapp.main

T8b949e# If you add your pip install location to

T8b949e# the PATH environment variable, you can

T8b949e# also run Sideband simply using:

sideband

If you have not already installed Python and T383838pip3 on your macOS system, download and install the latest version first.

Even though there is currently not an automated installer, or packaged T383838.exe file for Sideband on Windows, you can still install it through T383838pip. If you don't already have Python installed, download and install the latest version of Python.

Please note that audio messaging functionality isn't supported on Windows yet. Please support the development if you'd like to see this feature added faster.

Important! When asked by the installer, make sure to add the Python program to your PATH environment variables. If you don't do this, you will not be able to use the T383838pip installer, or run the T383838sideband command.

When Python has been installed, you can open a command prompt and install sideband via T383838pip:

T282828

The Sideband application can now be launched by running the command T383838sideband in the command prompt. If needed, you can create a shortcut for Sideband on your desktop or in the start menu.

When running Sideband for the first time, a default Reticulum configuration file will be created, if you don't already have one. If you don't have any existing Reticulum connectivity available locally, you may want to edit the file, located at T383838C:\Users\USERNAME\.reticulum\config and manually add an interface that provides connectivity to a wider network. If you just want to connect over the Internet, you can add one of the public hubs on the Reticulum Testnet.

You can try out the paper messaging functionality by using the following QR-code. It is a paper message sent to the LXMF address T3838386b3362bd2c1dbf87b66a85f79a8d8c75. To be able to decrypt and read the message, you will need to import the following base32-encoded Reticulum Identity into the app:

T3838383BPTDTQCRZPKJT3TXAJCMQFMOYWIM3OCLKPWMG4HCF2T4CH3YZHVNHNRDU6QAZWV2KBHMWBNT2C62TQEVC5GLFM4MN25VLZFSK3ADRQ=

You can import the identity into Sideband in the Encryption Keys part of the program. After the you have imported the identity, you can scan the following QR-code and open it in the app, where it will be decrypted and added to your messages.

<p align="center"><img width="50%" src="https://raw.githubusercontent.com/markqvist/LXMF/master/docs/papermsgtest.png"/></p>

You can also find the entire message in <a href="lxm://azNivSwdv4e2aoX3mo2MdTAozuI7BlzrLlHULmnVgpz3dNT9CMPVwgywzCJP8FVogj5jkU7j7ywuvBNcr45kRTrd19c3iHenmnSDe4VEd6FuGsAiT0Khzl7T81YZHPTDhRNp0FdhDE9AJ7uphw7zKMyqhHHxOxqrYeBeKF66gpPxDceqjsOApvsSwggjcuHBx9OxOBy05XmnJxA1unCKgvNfOFYc1T47luxoY3c0dLOJnJPwZuFRytx2TXlQNZzOJ28yTEygIfkDqEO9mZi5lgev7XZJ0DvgioQxMIyoCm7lBUzfq66zW3SQj6vHHph7bhr36dLOCFgk4fZA6yia2MlTT9KV66Tn2l8mPNDlvuSAJhwDAxx2PN9zKadCjo9sItkAp8r-Ss1CzoUWZUAyT1oDw7ly6RrzGBG-e3eM3CL6u1juIeFiHby7_3cON-6VTUuk4xR5nwKlFTu5vsYMVXe5H3VahiDSS4Q1aqX7I">this link</a>:

T383838lxm://azNivSwdv4e2aoX3mo2MdTAozuI7BlzrLlHULmnVgpz3dNT9CMPVwgywzCJP8FVogj5j_kU7j7ywuvBNcr45kRTrd19c3iHenmnSDe4VEd6FuGsAiT0Khzl7T81YZHPTDhRNp0FdhDE9AJ7uphw7zKMyqhHHxOxqrYeBeKF66gpPxDceqjsOApvsSwggjcuHBx9OxOBy05XmnJxA1unCKgvNfOFYc1T47luxoY3c0dLOJnJPwZuFRytx2TXlQNZzOJ28yTEygIfkDqEO9mZi5lgev7XZJ0DvgioQxMIyoCm7lBUzfq66zW3SQj6vHHph7bhr36dLOCFgk4fZA6yia2MlTT9KV66Tn2l8mPNDlvuSAJhwDA_xx2PN9zKadCjo9sItkAp8r-Ss1CzoUWZUAyT1oDw7ly6RrzGBG-e3eM3CL6u1juIeFiHby7_3cON-6VTUuk4xR5nwKlFTu5vsYMVXe5H3VahiDSS4Q1aqX7I

On operating systems that allow for registering custom URI-handlers, you can click the link, and it will be decoded directly in your LXMF client. This works with Sideband on Android.

You can help support the continued development of open, free and private communications systems by donating via one of the following channels:

• Monero:

T282828

• Ethereum

T282828

• Bitcoin

T282828

• Ko-Fi: https://ko-fi.com/markqvist

<br/>

• <s>Secure and private location and telemetry sharing</s>

• <s>Including images in messages</s>

• <s>Sending file attachments</s>

• <s>Offline and online maps</s>

• <s>Paper messages</s>

• <s>Using Sideband as a Reticulum Transport Instance</s>

• <s>Encryption keys export and import</s>

• <s>Plugin support for commands, services and telemetry</s>

• <s>Adding Linux .desktop file integration</s>

• <s>Sending voice messages (using Codec2 and Opus)</s>

• Implementing the Local Broadcasts feature

• LXMF sneakernet functionality

• Network visualisation and test tools

• A debug log viewer

• Better message sorting mechanism

• Fix I2P status not being displayed correctly when the I2P router disappears unexpectedly

• Adding a Nomad Net page browser

Unless otherwise noted, this work is licensed under a [Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International License][cc-by-nc-sa].

Permission is hereby granted to use Sideband in binary form, for any and all purposes, and to freely distribute binary copies of the program, so long as no payment or compensation is charged or received for such distribution or use.

<img src="https://licensebuttons.net/l/by-nc-sa/4.0/88x31.png" align="right">

[cc-by-nc-sa]: http://creativecommons.org/licenses/by-nc-sa/4.0/

[cc-by-nc-sa-image]: https://licensebuttons.net/l/by-nc-sa/4.0/88x31.png

[cc-by-nc-sa-shield]: https://img.shields.io/badge/License-CC%20BY--NC--SA%204.0-lightgrey.svg